home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / EDU / DISK2709.ZIP / BALLOONS.DOC next >
Text File  |  1991-03-29  |  9KB  |  216 lines
  1.  
  2. This is the documentation for BALLOONS.EXE  (c)1990 by AssistWare
  3.  
  4. DESCRIPTION:
  5.  
  6. This program draws a balloon and sounds a tone when any key is
  7. hit.  The balloons are a random size, color and are drawn at
  8. random locations on the screen.  Each key is assigned a different
  9. tone (one can play tunes by pressing the appropriate keys).
  10.  
  11. Hitting the down-arrow key causes the balloon to shrink until it
  12. disappears.
  13.  
  14. Hitting the up-arrow key causes the balloon to grow until it
  15. pops. After the pop, a rainbow is drawn and the first line of
  16. "Twinkle, Twinkle Little Star" is played.
  17.  
  18. For EGA & VGA monitors, Hitting the G makes green balloons
  19.                                     B makes blue balloons
  20.                                     R makes red balloons
  21.                                     Y makes yellow balloons
  22.                                     W makes white balloons
  23.  
  24. For CGA monitors,  Hitting the Y makes yellow balloons
  25.                                G makes green balloons
  26.                                R makes red balloons
  27.  
  28. Hitting qu (short for quit) stops the program.....
  29.  
  30. Don't forget or you will have to CTL-ALT-DEL to get out.
  31.  
  32. =================================================================
  33.  
  34. STARTING THE PROGRAM:
  35.  
  36. Invocation parameters:  (i.e.  BALLOONS parameter)
  37.  
  38. If no parameter is used the program tries to determine which
  39. monitor your computer has and then writes directly to the video
  40. card RAM.  Writing directly to the video card RAM only works if
  41. your system's video hardware is identical to IBM display adapters.
  42. (Writing directly to the video card RAM makes the program draw
  43. the balloons faster.)
  44.  
  45. > I suggest that you try starting the program with no parameters,
  46. > i.e. BALLOONS    and see if it works, only using the following
  47. > parameters if needed.
  48.  
  49. The following table shows the valid parameters.  You may wish to
  50. use these if the program is unable to determine which monitor
  51. your computer has.
  52.  
  53.                           | write directly |     use DOS
  54.          Monitor          |  to video card | video interface
  55.  -------------------------+----------------+-----------------
  56.     CGA                   |      30        |       130
  57.     EGA (low resolution)  |      40        |       140
  58.     VGA (low resolution)  |      50        |       150
  59.    MCGA                   |      60        |       160
  60.     VGA (high resolution) |      70        |       170
  61.     EGA (high resolution) |      80        |       180
  62.     Let program decide    |                |       120
  63.  
  64. Examples: - Invoke program for a CGA monitor writing directly to
  65.             the video card:  balloons 30
  66.           - Invoke program for a MCGA monitor using the DOS video
  67.             interface:  balloons 160
  68.           - Invoke program and let program decide the best choice
  69.             and use the DOS video interface:  balloons 120
  70.           - Invoke program and let program decide the best choice
  71.             and write directly to the video card:  balloons
  72.  
  73. =================================================================
  74.  
  75. OTHER CONSIDERATIONS:
  76.  
  77. - If your monitor is set to 40 column mode, set it to 80 column
  78.   color mode before the program is started:
  79.   (use the DOS command:  MODE CO80).
  80.  
  81. - To allow a small child to continuously a key down and the
  82.   program run without overflowing the keyboard buffer, the
  83.   program discards all keys which are in the keyboard buffer
  84.   immediately before it starts to draw a balloon, while the
  85.   balloon is popping and while the rainbow is being drawn.  For
  86.   slow machines this has the following implication:
  87.      The processor may not be fast enough to discard all of the
  88.      extra keys and draw the balloons at the same time.  If this
  89.      occurs, you will hear the high-pitched beep that indicates
  90.      the keyboard buffer has overflown.  Just take your hand off
  91.      of the key for an instant and the program will have time to
  92.      discard the keys in the buffer and draw the balloon.  This
  93.      problem does not occur with faster machines.
  94.  
  95. - If you have a CGA monitor, the program can only draw balloons
  96.   in 3 different colors.  This restriction is due the way Turbo C
  97.   and the CGA video card work together.
  98.  
  99. =================================================================
  100.  
  101. ERRORS:
  102.  
  103. If the program had an error and could not continue, try the
  104. following:
  105.  
  106. 1. Run the program again, invoking it with a parameter.
  107.    A list of invocation parameters are given by invoking the
  108.    program with a ?.
  109.    - for example:  balloons ?     (The list is also given above.)
  110.    Then pick the parameter that appears to best fit your
  111.    computer's monitor.
  112.  
  113. 2. If you are a registered user, send the following information
  114.    to:  AssistWare, 1505 Sedwick Rd., Durham, NC  27713
  115.    a. The type of computer you have.
  116.    b. The type of monitor you have.
  117.    c. The DOS version you are using.
  118.    d. The program version.
  119.    e. The program error number and a description of your problem.
  120.  
  121.    We will make a good-faith effort to fix your problem.
  122.  
  123. =================================================================
  124.  
  125. MY CHILD'S EXPERIENCE:
  126.  
  127. This program was written for my son, Charles, who wanted to work
  128. on the computer (hit on the keyboard), because he saw his parents
  129. doing this. However, he was too young mentally and did not have
  130. the fine motor skills necessary for programs that show A when "a"
  131. is hit, etc.  He just wanted to push the keys and see something
  132. happen.  He likes balloons and rainbows and "Twinkle, Twinkle
  133. Little Star" was one of his favorite songs.  So this program was
  134. conceived to give him a way to hit any key and see something
  135. happen. He learned surprisingly quickly (and remembered) where the
  136. up and down arrow keys are and the keys that made the color of
  137. balloons he liked (G, B and R). This program has been a very
  138. positive experience for Charles; I hope you find that to be true
  139. for your child as well.
  140.  
  141. As an aside, because his favorite color is green, when the
  142. balloons are made randomly, there will be more green ones than
  143. any other color.
  144.  
  145. ==================================================================
  146.  
  147. PACKAGE CONTENTS:
  148.  
  149. This package contains 3 files: BALLOONS.EXE -- the program.
  150.                                BALLOONS.DOC -- this file.
  151.                                BALLOONS.REG -- the registration form.
  152.  
  153. ==================================================================
  154.  
  155. Association of Shareware Professionals - Ombudsman Statement
  156.  
  157.   This program is produced by a member of the Association
  158.   of Shareware Professionals (ASP).  ASP wants to make sure
  159.   that the shareware principle works for you. If you are
  160.   unable to resolve a shareware-related problem with an ASP
  161.   member by contacting the member directly, ASP may be able
  162.   to help. The ASP Ombudsman can help you resolve a dispute
  163.   or problem with an ASP member, but does not provide
  164.   technical support for members' products. Please write to
  165.   the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427
  166.   or send a CompuServe message via CompuServe Mail to ASP
  167.   Ombudsman 70007,3536."
  168.  
  169. ==================================================================
  170.  
  171. WARRANTY:
  172.  
  173. Users of Balloons must accept this disclaimer of warranty:
  174.  
  175. Balloons is supplied as is.  The author disclaims all warranties,
  176. expressed or implied, including, without limitation, the
  177. warranties of merchantability and fitness for any purpose.  The
  178. author assumes no liability for damage, direct or consequential,
  179. which may result from the use of Balloons.
  180.  
  181. ==================================================================
  182.  
  183. DISTRIBUTION OF PROGRAM:
  184.  
  185. You can give a copy of this program to anyone who wants it.  Please
  186. encourage them to register if they find the program useful.
  187.  
  188. ==================================================================
  189.  
  190. REGISTRATION PROCESS AND FEE:
  191.  
  192. I hope your child is enjoying the "BALLOONS" program.  My two-
  193. year old son, Charles, has a great time with it, and asks to
  194. "work on the 'puter" frequently in order to make balloons and
  195. then pop them.
  196.  
  197. My husband and I are honest people; I trust that you are as well.
  198. If you find this program valuable and your child enjoys it,
  199. please send $7.00 (check or money order) to:  Patti B. Lingafelt
  200.                                               1505 Sedwick Rd.
  201.                                               Durham, NC  27713
  202. Please use the registration form included with this program
  203. (balloons.reg).  Just print it and mail it in.
  204.  
  205. I will then register you as a user, entitling you to future
  206. upgrades, technical support and information about other programs
  207. for your child.
  208.  
  209.  
  210. Thank you.
  211.  
  212. Patti B. Lingafelt
  213. 1505 Sedwick Rd.
  214. Durham, NC  27713
  215. 919-544-5567
  216.